
Common Setup Procedures & Revision History

Current Emulator Setup
The emulator defaults to 2MB of GS RAM. To be adjustable in the future.
The Mac OS port looks for a file "hd1.xgs" in the XGS application directory. This is the boot-drive.
The Mac OS port looks for a file "hd2.xgs" in the XGS application directory. Use this to mount a second disk.
The Mac OS port expects the files "xgs.rom", "xgs40.fnt" and "xgs80.fnt" to be in the XGS application directory.

Keyboard Layout
Taken from the General "README" file. Most options are implemented in the menus.

Control-End		     Quits (ends) XGS.
Control-Home		    Sends a Control-Reset to the emulator.
Control-PageUp		  Turns on trace mode.
Control-PageDown	 Turns off trace mode.

Pause/F15	Sends a Non-Maskable Interrupt (NMI) to
									 the emulator. This is a guaranteed way
							 		to get into the monitor and poke around.
						 			This also dumps a copy of banks $00 and $01
						 			into banks $E8 and $E9 for debugging
						 			purposes.

F5        ***Not implemented in XGS-Mac yet!***
          Toggle joystick emulation on/off. Note that
					  			you can't turn on joystick emulation unless
								 	mouse emulation is off!

F6			     Toggle mouse emulation on/off. Note that you
							 		can't turn on mouse emulation unless joystick
							 		emulation is off!

IIGS ROM Extraction
1) Read the General "README" file for the specifics.
2) Obtain a boot disk that enters BASIC System.
3) Insert the floppy and copy the "rom01dump.exec" or "rom03dump.exec" files (MacOS recognizes ProDOS disks!). Eject the floppy and insert it in your IIGS.
4) Boot into Basic System. Now, execute the "rom01dump.exec" or "rom03dump.exec" files at the BASIC interpreter with the command
        EXEC rom0xdump.exec
where x is the version of your IIGS's ROM.
5) Insert the floppy back to your Mac. The XGS.ROM file should now exist on this disk.
6) Copy the image to the XGS directory. You can now launch XGS successfully.

Disk Image Conversion
1) Obtain a DiskCopy disk image of the Apple II formatted file you wish to convert.
2) Move the DiskCopy disk image into the directory which contains the "XGS Disk Utilities" application.
3) Run the XGS Utils program and execute the "XGS Disk Utilities" application.
4) Choose "1) Disk Copy Image -> XGS Image" from the text menu.
5) Follow the prompt as directed. For example, if your DiskCopy disk image name is "System.Disk", make your XGS boot disk by naming the XGS image "hd1.xgs". You should type "System.Disk  hd1.xgs" in the dialog that pops up and hit return.
6) If an image named "hd1.xgs" is in the XGS application directory, run XGS, and the emulator will attempt to boot it!

To Do
-----
  Better GUI support for XGS. Finish implementing the menus--In progress.
  Better GUI support for XGS Disk Utilities--In progress.
  Support DiskCopy images.
  Sound is ported. Will be made asynchronous eventually.
  Video is ported, but could be better. Currently needs to have 0/255 CLUT
   values swapped all the time, to retain a clean offscreen buffer. --In progress.
  Improve mouse/keyboard input to be more responsive and emulate the
   GS control panel preferences.
  Directly emulate the extended ADB keyboard for the GS if the Mac host has one connected.

Revision History
Version 0.46r1  1/16/97
======================
 Initial public release. Basic interface support.

Version 0.46p1  01/14/97 through
Version 0.44p1  01/05/97
========================
 Decided that release versions will be noted by "X.XXrY", where X.XX is the
  emulator core version and rY is the release revision of the Mac port.
 Fixed an unmapped memory exception bug when using SIOUX that prevented
  the release of 0.45. Hint: Print to SIOUX only after menus are installed, not before!
 Emulated Ensoniq sound supported!
 Prototypes of the port (unreleased).
